Transfer to Bank
Berfungsi untuk melakukan transfer saldo SpeedCash ke rekening bank
info
respon akan di dapat setelah user melakukan input pin, halaman input pin akan di informasikan terpisah, akan timeout setelah 5 menit tidak ada pin yang terinput di halaman pin
note
Ketika digunakan untuk transfer dari id master perlu dilakukan whitelist rekening di sistem SpeedCash, dan tanpa halam input pin
Sequence Diagram
Bagian berikut akan menjelaskan tentang detail teknis untuk proses transfer bank.
note
Pastikan partnerReferenceNo
pada request dan params di url input pin sama agar terproses
Service Info
HTTP Method | POST |
---|---|
Service Code | 43 |
Http Method | POST |
Path | .../{version}/emoney/transfer-bank |
Header
Header Name | Tipe Data | Wajib | Deskripsi |
---|---|---|---|
Content-Type | String | Y | application/json |
Authorization | String | Y | Token B2B |
Authorization-Customer | String | Y | Token B2B2C |
X-SIGNATURE | String | Y | Dibuat dengan algoritma asymmetric with token B2B2C : Signature Generation |
X-PARTNER-ID | String | Y | Client’s client_id (diberikan pada saat onboarding ) |
X-EXTERNAL-ID | String | Y | Nomor referensi yang harus unik pada hari yg sama |
CHANNEL-ID | String | Y | 00001 untuk PJP and 00002 untuk non PJP |
Body
Parameter | Tipe Data | Wajib | Deskripsi |
---|---|---|---|
partnerReferenceNo | String | Y | Pengidentifikasi transaksi pada sistem konsumen layanan Length: <= 64 karakter |
customerNumber | String | Y | Nomor Akun Pelanggan Length: <= 32 karakter |
beneficiaryAccountNumber | String | Y | Nomor rekening penerima Length: <= 32 karakter |
beneficiaryBankCode | String | Y | Kode bank Lenght: <= 8 karakter |
amount | Object | Y | Jumlah |
additionalInfo | Object | Y | Informasi Tambahan |
notes | Object | N | Deskripsi |
bankAccountName | Object | Y | Nama Penerima |
referenceNo | Object | Y | Kode Trankasi didapat dari bank-account-inquiry |
transactionCode | Object | Y | Kode Trankasi inquiry didapat dari bank-account-inquiry |
merchantId | String | Y | Kode unik yang dimiliki setiap user Length: <= 64 characters |
centralId | String | C | Id master Key length: <= 6 characters nb: hanya ketika transfer dari id master |
Request samples
- JSON
- CURL
{
"partnerReferenceNo": "202411071648522545240215",
"customerNumber": "0812xxxxxxxx",
"beneficiaryAccountNumber": "14200xxxxxxxx",
"beneficiaryBankCode": "008",
"amount": {
"value": "10000.00",
"currency": "IDR"
},
"additionalInfo": {
"notes": "WITHDRAWAL",
"bankAccountName": "ROSIDI DRAGON",
"referenceNo": "5305899",
"transactionCode": "87375305",
"merchantId": "121xxxx"
}
}
curl --location --request POST '.../v1.0/emoney/transfer-bank' \
--header 'X-TIMESTAMP: 2023-01-27T13:51:00+07:00' \
--header 'X-SIGNATURE: RwABEherf+3MTBhIf6vtju6ko+YOFFKWLGgHCD5RwX1I17JCKVn8ffc/TenEIly85InhuIcKCDqDrxbIBhaKEg==' \
--header 'X-PARTNER-ID: 085224a9-4b42-4f7d-959f-4452f8a9a1ff' \
--header 'X-EXTERNAL-ID: 024a31b6-e0c8-429a-9d41-83a2f44b6844' \
--header 'X-DEVICE-ID: android-20013adf6cdd8123f' \
--header 'CHANNEL-ID: 12345' \
--header 'Authorization: Bearer bb005fcb-dea9-499a-9e7a-bcf651b2334e' \
--header 'Authorization-Customer:Bearer 5b8bbaf8-4aca-4072-9ea8-d85bed65105f' \
--header 'Content-Type: application/json' \
--data '{
"partnerReferenceNo": "202411071648522545240215",
"customerNumber": "0812xxxxxxxx",
"beneficiaryAccountNumber": "14200xxxxxxxx",
"beneficiaryBankCode": "008",
"amount": {
"value": "10000.00",
"currency": "IDR"
},
"additionalInfo": {
"notes": "WITHDRAWAL",
"bankAccountName": "ROSIDI DRAGON",
"referenceNo": "5305899",
"transactionCode": "87375305",
"merchantId": "121xxxx"
}
}'
Struktur Respons
Parameter | Tipe Data | Deskripsi |
---|---|---|
responseCode | String | Kode respons Length: <= 7 karakter |
responseMessage | String | Deskripsi respons Length: <= 150 karakter |
referenceNo | String | Kode Transaksi Decode |
beneficiaryAccountNumber | String | Nomor rekening tujuan Length: <= 32 karakter |
beneficiaryAccountName | String | Nama penerima tujuan Length: <= 64 karakter |
beneficiaryBankCode | String | Kode bank Length: <= 8 karakter |
beneficiaryBankName | String | Nama bank Length: <= 25 karakter |
amount | Object | Jumlah |
additionalInfo | Object | Informasi Tambahan |
description | String | Deskripsi |
Response samples
{
"responseCode": "2004300",
"responseMessage": "Successful",
"referenceNo": "5037081",
"referenceNumber": "5037081",
"additionalInfo": {
"description": "Transaksi Anda berhasil."
}
}
Response Code Transfer to Bank
Response Code | Response Message | Description |
---|---|---|
2004300 | Success | Sukses |
4004301 | Invalid field format { field name } | Format invalid |
4004302 | Invalid mandatory field {field name} | Format pada bidang wajib tidak ada atau tidak valid |
4014300 | Unauthorized. Invalid Signature | X-Signature salah |
4094300 | Cannot use same X-EXTERNAL-ID in same day | X-External-ID sudah pernah digunakan di hari yang sama |
4044301 | Bad Request | Request header ada yang salah / kurang |
4044301 | Unauthorized. Client Forbidden Access API | Partner tidak dapat mengakses api terkait |